home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 1 / Atari Mega Archive - Volume 1.iso / telecomm / xprogs.arc / XDOCS.TXT < prev    next >
Text File  |  1988-01-05  |  4KB  |  64 lines
  1. Program names:    xdown.ttp    xup.ttp
  2. Versions:    1.1        1.1
  3. Last mod:    1/4/88        1/4/88
  4. Author:        Jason Blochowiak
  5. Docs author:    Same
  6. Status:        Public Domain
  7.  
  8.     Ok, the not-so-long awaited stand-alone xmodem utilities...
  9. xup.ttp is a program to upload (send from your computer to somewhere else)
  10. files. xdown.ttp is a program to download (receive files from another computer)
  11. files. Neither of them is, as far as I'm aware, the least bit buggy (doesn't
  12. mean that they really aren't...).
  13.  
  14.     Purpose in life: These programs are designed primarily for use with
  15. the Atari vt52 emulation desk accessory that people got with their STs, so that
  16. they can have xmodem transfers without paying for a terminal program. I won't
  17. wax philosophically on how great computer telecommunications are, there are
  18. enough other people doing that, but: I find this stuff interesting, and am
  19. trying (by releasing this stuff to PD) to make more accessable to an average
  20. person (without them having to spend as much). Or, it's great for when your
  21. "real" terminal program is being buggy, and you just gotta get some files
  22. transferred...
  23.  
  24.     How to use: First off, you have to be connected to another computer
  25. by some method (modem or null-modem, most likely), and have communications
  26. established (proper baud rate, parity, etc. I won't explain this; if you
  27. need it explained, there are lots of people out there who understand it). Then
  28. you must tell the other computer that you would like it to send a file to you
  29. by xmodem checksum (also called Standard Xmodem, Christiansen protocol, Xmodem
  30. CHK), or that you're going to send it a file via xmodem checksum. Exactly how
  31. you're supposed to tell the system of your intentions is pretty much up to the
  32. system that you're connected to, so get help from there (yeah, I know, I'm
  33. being _real_ helpful... I've gotta shower and get to a movie soon!). Once the
  34. other system knows what you're going to do, and says that it's ok in some way,
  35. shape, or form, exit from the VT52 emulator by pressing the Undo key. Once
  36. you're back to the GEM Desktop, double-click on the XUP.TTP icon (or text) if
  37. you're sending a file, or double-click on XDOWN.TTP if you're going to be
  38. recieving a file. When the Desktop asks you what parameters to give to the
  39. program, type in the name of the file that you want to send or recieve. Then
  40. the program should kick in... It should clear the screen, print my brag line,
  41. and then sit there for a few seconds, and then start doing something.
  42.  
  43.     Operation: xup and xdown (the "xprogs" for the rest of the docs) print
  44. something on the left side of the screen (S# for xup, R# for xdown. Short for
  45. Send and Recieve, respectively), and a number. The number shows where in the
  46. transfer the program is. To figure out how many characters have been
  47. sent/recieved, take the number there, and multiply it by 128. When it's done,
  48. it'll tell you either "successful send" (or "successful recieve"), or
  49. "too many errors." Don't worry about anything else that's printed; the file got
  50. transferred if it said it was successful, or it didn't get transferred if it
  51. said there were too many errors. For an explaination of the errors it does give
  52. (they are English, sort of...), find an experienced person...
  53.  
  54.     Source code: Yep, it's here, but this version isn't commented... I'll
  55. probably do that in the near future. It's C compiled under the Mark Williams
  56. C package (awesome compiler!!!), so there might be some library routines that
  57. I use that Alcyon or Megamax don't have... I think everything else is
  58. "clean" C, but then again, I haven't checked. There's also a routine called
  59. itoa() which converts ints to strings (it doesn't convert the #10 properly...
  60. I'll fix that sometime), which I included separately (I have it in my library).
  61.  
  62.     Jason Blochowiak,
  63.         1/4/88
  64.